Редактирование названия подразделения

Запрос позволяет изменить название подразделения.

Синтаксис запроса

PUT https://business.taxi.yandex.ru/api/1.0/client/{идентификатор клиента}/department/{идентификатор подразделения}

🔴 Рекомендуем использовать API 2.0. Поддержка API 1.0 в будущем будет прекращена.

Заголовки запроса:

Authorization

OAuth-токен. Процесс получения токена описан в разделе Начало работы.

Данные о новом названии подразделения передаются в теле запроса, в формате JSON:

Поле Описание Формат
parent_id id родительского подразделения (null — для корневого подразделения). Строка
name Название подразделения. Строка

Пример запроса

PUT https://business.taxi.yandex.ru/api/1.0/client/233e...fd7/department/2f0....34c53
...
Authorization: <OAuth-токен>


{
       "parent_id": "233e725b0511459da7b38cb24f2d8fd7",
       "name": "Some department"
}

Пример ответа

Пример ответа на данный запрос выглядит следующим образом:

{}

Возможные коды ответа

Ответ на данный запрос может содержать следующие стандартные HTTP-коды:

  • 200 — запрос выполнен успешно.
  • 400 — в запросе был передан неизвестный параметр или параметр с недопустимым значением.
  • 401 — был передан неверный OAuth-токен.
  • 403 — у клиента не хватает прав на выполнение данного запроса.
  • 404 — указанная запись не найдена.